AWeb ARexx-Befehle

Befehle für Einstellungen

Einzelne Einstellungen:
ALLOWCMD ANONYMOUS AREXX BACKGROUND BGSOUND BLINK BUTTON CACHEDISK CACHEMEMORY CACHEPATH COLOUR CONSOLE COOKIES CYCLETOLIST DRAGGING EDITOR	ENDTCP FASTRESPONSE FONT FTPPROXY GOPHERPROXY HISTORYCLOSE HISTORYOPEN HOMEURL HOTLISTCLOSE HOTLISTOPEN HOTLISTREQUESTER HTMLMODE HTMLVIEWER HTTPPROXY ICONS IGNOREMIME	IMAGES IMAGEVIEWER INDEXSUFFIX KEEPFREECHIP KEEPFREEFAST LIMITEDPROXY MAILTO MAXLOCAL MAXNETWORK MIME NETSTATUSOPEN NEWS NOCACHE NOCOOKIE NOPROXY OVERLAP	PALETTE POPUP POPUPMENU SAVEPATH SCREEN SCREENPENS SHOWBUTTONS STARTHOME STARTTCP STYLE TELNET TELNETPROXY TEMPPATH ULLINKS VERIFICATION

GETCFG

Schablone:


   GETCFG ITEM,VAR/K,STEM/K

Beschaffen einer oder mehrerer Einstellungen.

Argument Beschreibung
ITEM Spezifiziert den Namen der zu beschaffenden einzelnen Einstellung, der Gruppe oder der Liste.
Wenn nicht angegeben, wird ein Array aller Konfigurationspunkte erstellt.
VAR Der Name der Variablen, die den Wert einer einzelnen Einstellung zurückgibt. Wird kein Name angegeben, so wird der Wert einer einzelnen Einstellung in der reservierten ARexx-Variable RESULT zurückgegeben.
STEM Der Name einer Stammvariablen, in der ein Array mit einzelnen Werten übergegeben wird. Das gilt für Gruppen, Listen oder für alle zu beschaffenden Einstellungen. Beziehen Sie keinen Trennpunkt in diesen Namen ein.

Argument	Beschreibung
ITEM	Spezifiziert den Namen der zu beschaffenden einzelnen Einstellung, der Gruppe oder der Liste. Wenn nicht angegeben, wird ein Array aller Konfigurationspunkte erstellt.
VAR	Der Name der Variablen, die den Wert einer einzelnen Einstellung zurückgibt. Wird kein Name angegeben, so wird der Wert einer einzelnen Einstellung in der reservierten ARexx-Variable `RESULT` zurückgegeben.
STEM	Der Name einer Stammvariablen, in der ein Array mit einzelnen Werten übergegeben wird. Das gilt für Gruppen, Listen oder für alle zu beschaffenden Einstellungen. Beziehen Sie keinen Trennpunkt in diesen Namen ein.

SETCFG

Schablone:


   SETCFG ITEM,VALUE,STEM/K,ADD/S

Setzt eine oder mehrere Einstellungen. Nach Ausführen dieses Befehles werden die neuen Einstellungen aktiv. Möglicherweise erfolgt eine Aktualisierung des Layouts des aktuellen Dokumentes (oder zumindest wird der Bildschirm geschlossen und neu geöffnet). Wenn Sie mehrere Einstellungen zur gleichen Zeit setzen wollen, ist es am sinnvollsten, alle Einstellungen in einem Array zusammenzufassen. Zusätzliche Vorgänge müßten somit nur einmal ausgeführt werden.

Argument Beschreibung
ITEM Spezifiziert den Namen der zu setzenden Einstellung.
VALUE Der Wert der zu setzenden Einstellung mit diesem Namen.
STEM Der Name der Stammvariablen, die ein die einzelnen Einstellungen enthaltendes Array darstellt. Die Einstellungen in diesem Array gehören nicht zwangsläufig zur gleichen Gruppe oder Liste.
ADD Wenn dieser Schalter gesetzt ist, werden alle Einstellungen in einer Liste den momentanen Einstellungen hinzugefügt.
Wenn dieser Schalter nicht gesetzt ist, und Einstellungen in einer Liste vorhanden sind, ersetzten diese die vorhandene Liste für diese Einstellung.

Argument	Beschreibung
ITEM	Spezifiziert den Namen der zu setzenden Einstellung.
VALUE	Der Wert der zu setzenden Einstellung mit diesem Namen.
STEM	Der Name der Stammvariablen, die ein die einzelnen Einstellungen enthaltendes Array darstellt. Die Einstellungen in diesem Array gehören nicht zwangsläufig zur gleichen Gruppe oder Liste.
ADD	Wenn dieser Schalter gesetzt ist, werden alle Einstellungen in einer Liste den momentanen Einstellungen hinzugefügt. Wenn dieser Schalter nicht gesetzt ist, und Einstellungen in einer Liste vorhanden sind, ersetzten diese die vorhandene Liste für diese Einstellung.

Stammvariablen

Die für die Ausgabe für den GETCFG-Befehl oder als Eingabe für den SETCFG-Befehl verwendete Stammvariable stellt ein Array mit strukturierten Informationen dar. Jedes Array-Element enthält den Namen und den Wert eines Konfigurationspunktes.

Bestandteile der strukturierten Informationen
Name	Beschreibung
ITEM	Name des Konfigurationspunktes.
VALUE	Wert des Konfigurationspunktes.

Typen von Konfigurationspunkten

Es gibt drei grundlegende Typen von Konfigurationspunkten: Einzelne Einstellungen, Gruppen, und Listen.

Die einzelne Einstellung

Eine einzelne Einstellung ist die kleinste Konfigurationseinheit, und wird durch ihren Namen identifiziert.

Beispiel: HTMLMODE ist die einzelne Einstellung, die den HTML-Modus des Browsers bestimmt..

Gruppen

Eine Gruppe ist ein Satz mit Einstellungen, die eng miteinander in Beziehung stehen. Die einzelnen Einstellungen werden durch ihren Gruppennamen und durch ihren individuellen Namen identifiziert und werden durch einen Punkt getrennt. Beim GETCFG-Befehl kann der Gruppenname zum Beschaffen der gesamten Gruppe angegeben werden (in einer Stammvariablen).

Beispiel: STYLE ist eine Gruppe, die alle Browser-Einstellungen bezüglich Styles enthält. STYLE.H3 und STYLE.BLOCKQUOTE sind zwei individuelle Einstellungen innerhalb dieser Gruppe.

Listen

Eine Liste enthält einen oder mehrere Werte für die gleiche Einstellung. Diese Werte können nicht einzeln beschafft werden, sondern nur mit Hilfe eines Arrays. Die Array-Elemente für diese Liste haben allesamt den gleichen Namen.

Es ist möglich, individuelle Werte mit dem Befehl SETCFG zu setzen oder hinzuzufügen. Wenn der ADD-Schalter gesetzt ist, wird der Wert der Liste hinzugefügt. Ist dies nicht der Fall, so werden alle Werte innerhalb der Liste durch den neuen Wert ersetzt.

Beispiel: MIME ist eine Liste, die alle MIME-Typen and alle externen Programmeinstellungen enthält.

Einzelne Einstellungen

ALLOWCMD

Programmeinstellungen, Optionen: Ermögliche Shell-Befehle in Links.

Wert: Boolean (0 oder 1).

ANONYMOUS

Netzwerkeinstellungen, Optionen: Anonym browsen.

Wert: Boolean (0 oder 1).

AREXX

Gui-Einstellungen, ARexx: ARexx-Makro-Menü.

Es handelt sich um eine Liste mit individuellen Menüeinträgen.

Wert jedes Eintrages: String mit dem Format:

   Tastaturkürzel;Makro;Titel

Tastaturkürzel	Eine Zahl in Bereich von 1...10, die das Tastaturkürzel für das Menü repräsentiert (1 = rechte-Amiga + 1; 9 = rechte-Amiga + 9; 10 = rechte-Amiga + 0). 0 gibt an, daß kein Tastaturkürzel verwendet wird.
Makro	Name und Pfad des mit dem Menüpunkt assoziierten ARexx-Makros.
Titel	Der im Menü angezeigte Titeltext.

BACKGROUND

Browsereinstellungen, Optionen: Benutze Hintergrund und Farben.

Wert: Boolean (0 oder 1).

BGSOUND

Browsereinstellungen, Optionen: Benutze Hintergrundmusik.

Wert: Boolean (0 oder 1).

BLINK

Browsereinstellungen, Optionen: Blinken.

Wert: Zahl im Bereich von 0...40, welche die Blinkrate in Zehntelsekunden angibt. Bei 0 erfolgt kein Blinken.

BUTTON

Gui-Einstellungen, Knöpfe: Benutzerdefinierte Knöpfe.

Es handelt sich um eine Liste mit individuellen Menüeinträgen.

Wert jedes Eintrages: String mit dem Format:

   Beschriftung NL Befehl

Beschriftung	Die Beschriftung des Knopfes.
NL	Ein Zeichen für eine neue Zeile (hexadezimal 0A).
Befehl	Der bei Anwahl des Knopfes auszuführende ARexx-Befehl.

CACHEDISK

Netzwerkeinstellungen, Puffer: Größe des Puffers auf Disk.

Wert: Darf nicht negativ sein. Spezifiziert die Größe des Disk-Puffers in kB.

CACHEMEMORY

Netzwerkeinstellungen, Puffer: Größe des Puffers im Speicher.

Wert: Darf nicht negativ sein. Spezifiziert die Größe des RAM-Puffers in kB.

CACHEPATH

Netzwerkeinstellungen, Puffer: Pufferpfad.

Wert: String, der einen DOS-Pfad angibt.

COLOUR

Browsereinstellungen, Farben: Vorgegebene Farben im Browser.

Diese Gruppe enthält die folgenden Einstellungen:

COLOUR.BACKGROUND Hintergrundfarbe für Dokument.
COLOUR.TEXT Textfarbe im Dokument.
COLOUR.LINK Farbe für bisher noch nicht besuchten Hyperlinks.
COLOUR.VLINK Farbe für bereits besuchte Hyperlinks.
COLOUR.ALINK Farbe für aktive (ausgewählte) Hyperlinks.
Wert für alle Einträge: String mit sechs Hexadezimalstellen, welcher den RGB Farbwert (RRGGBB) spezifiziert.

COLOUR.BACKGROUND	Hintergrundfarbe für Dokument.
COLOUR.TEXT	Textfarbe im Dokument.
COLOUR.LINK	Farbe für bisher noch nicht besuchten Hyperlinks.
COLOUR.VLINK	Farbe für bereits besuchte Hyperlinks.
COLOUR.ALINK	Farbe für aktive (ausgewählte) Hyperlinks.

CONSOLE

Programmeinstellungen, externe Programme: Spezifikationen des Konsolenfensters.

Wert: String, der eine Definition für ein Konsolenfenster angibt.

COOKIES

Netzwerkeinstellungen, Optionen: Benutze Cookies.

Wert: 0,1 oder 2:

0 Niemals einen Cookie merken oder schicken.
1 Benutzer vor Merken eines Cookie fragen.
2 Cookies merken und automatisch schicken.

0	Niemals einen Cookie merken oder schicken.
1	Benutzer vor Merken eines Cookie fragen.
2	Cookies merken und automatisch schicken.

CYCLETOLIST

Browsereinstellungen, Optionen: Zeige Cycle-Felder als Liste.

Wert: Boolean (0 oder 1).

DRAGGING

Programmeinstellungen, Optionen: Ermögliche Ziehen.

Wert: Boolean (0 oder 1).

EDITOR

Programmeinstellungen, externe Programme: Editor.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname des Editors.
Argumente	Argumente für den Editor.

ENDTCP

Netzwerkeinstellungen, externe Programme: Beende TCP.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname des Skriptes, das den TCP-Stack beendet.
Argumente	Argumente für das Skript.

FASTRESPONSE

Netzwerkeinstellungen, Puffer: Schnelle Antwort.

Wert: Boolean (0 oder 1).

FONT

Browsereinstellungen, Zeichensätze: Browser-Zeichensätze.

Diese Gruppe enthält die folgenden Einstellungen:

FONT.N# (# = 1..7) Normaler Zeichensatz in dieser Größe.
FONT.F# (# = 1..7) Zeichensatz mit fester Breite in dieser Größe.

FONT.N# (# = 1..7)	Normaler Zeichensatz in dieser Größe.
FONT.F# (# = 1..7)	Zeichensatz mit fester Breite in dieser Größe.

Wert für alle Einträge: String mit dem Format:

   Name/Größe

Name	Name des Zeichensatzes, einschließlich der Endung `.font`.
Größe	Zahl, welche die Größe des Zeichensatzes angibt.

FTPPROXY

Netzwerkeinstellungen, Proxy: Proxy für FTP.

Wert: String, bestehend aus der URL des Proxy, einschließlich des vorstehenden http://.

GOPHERPROXY

Netzwerkeinstellungen, Proxy: Proxy für Gopher.

Wert: String, bestehend aus der URL des Proxy, einschließlich des vorstehenden http://.

HISTORYCLOSE

Programmeinstellungen, Optionen: Fenster-Geschichte schließt automatisch.

Wert: Boolean (0 oder 1).

HISTORYOPEN

Programmeinstellungen, Optionen: Fenster-Geschichte automatisch öffnen.

Wert: Boolean (0 oder 1).

HOMEURL

Netzwerkeinstellungen, Optionen: Homepage.

Wert: String bestehend aus der URL der Homepage.

HOTLISTCLOSE

Programmeinstellungen, Optionen: Hotlist-Requester schließt automatisch.

Wert: Boolean (0 oder 1).

HOTLISTOPEN

Programmeinstellungen, Optionen: Hotlist automatisch öffnen.

Wert: Boolean (0 oder 1).

HOTLISTREQUESTER

Programmeinstellungen, Optionen: Hotlist-Knopf startet Requester.

Wert: Boolean (0 or 1).

HTMLMODE

Browsereinstellungen, Optionen: HTML-Modus.

Wert: 0, 1 oder 2:

0 Streng
1 Tolerant
2 Kompatibel

0	Streng
1	Tolerant
2	Kompatibel

HTMLVIEWER

Programmeinstellungen, externe Programme: HTML-Quelltext-Anzeiger.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname HTML-Anzeigers.
Argumente	Argumente für den HTML-Anzeiger.

HTTPPROXY

Netzwerkeinstellungen, Proxy: Proxy für HTTP.

Wert: String, bestehend aus der URL des Proxy, eischließlich des vorstehenden http://.

ICONS

Programmeinstellungen, Optionen: Piktogramme erzeugen.

Wert: Boolean (0 oder 1).

IGNOREMIME

Netzwerkeinstellungen, Optionen: Ignoriere MIME-Typ vom Server.

Wert: Boolean (0 oder 1).

IMAGES

Netzwerkeinstellungen, Optionen: Bilder laden.

Wert: 0, 1 oder 2:

0 Aus
1 Nur Maps
2 Alle Bilder

0	Aus
1	Nur Maps
2	Alle Bilder

IMAGEVIEWER

Programmeinstellungen, externe Programme: Bild-Anzeiger.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname des Bild-Anzeigers.
Argumente	Argumente für den Bild-Anzeiger.

INDEXSUFFIX

Netzwerkeinstellungen, Optionen: Lokaler Index.

Wert: String.

KEEPFREECHIP

Netzwerkeinstellungen, Puffer: Chip-Ram mindestens freilassen.

Wert: Darf nicht negativ sein. Spezifiziert die Speichergröße in kB.

KEEPFREEFAST

Netzwerkeinstellungen, Puffer: Fast-Ram mindestens freilassen.

Wert: Darf nicht negativ sein. Spezifiziert die Speichergröße in kB.

LIMITEDPROXY

Netzwerkeinstellungen, Proxy: Begrenzte Proxybenutzung.

Wert: Boolean (0 oder 1).

MAILTO

Netzwerkeinstellungen, externe Programme: Mailto:-Programm.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname Mailto:-Programmes oder Skriptes.
Argumente	Argumente für das Pogramm oder Skript.

MAXLOCAL

Netzwerkeinstellungen, Optionen: Maximale Zahl an lokalen Diskzugriffen.

Wert: Positive Zahl.

MAXNETWORK

Netzwerkeinstellungen, Optionen: Maximale Netzwerk-Verbindungen.

Wert: Positive Zahl.

MIME

Browsereinstellungen, Anzeiger: MIME-Typen und externe Anzeiger.

Das ist eine Liste mit individuellen Definitionen für MIME und für externe Anzeiger. Beachten Sie, daß die individuellen Einträge in der Liste bezüglich des MIME-Typs gleich bleiben. Auch wenn sie den ADD-Schalter beim SETCFG-Befehl benutzen, ersetzt eine Definition für einen MIME-Typ die bestehende Definition für diesen MIME-Typ.

Wert für jeden Eintrag: String mit dem Format:

   Typ/Subtyp;Erweiterungen;Aktion;Name;Argumente

Typ/Subtyp

MIME-Typ.

Erweiterungen

Vorgegebene Dateinamenerweiterungen für diesen MIME-Typ.

Aktion

Für diesen MIME-Typ auszuführende Aktionen. Gültige Aktionen sind:

D	Vorgabe
I	Intern
A	AWeb-Plugin
E	Externes Programm
P	Externes Programm mit PIPE:
S	Speichere lokal auf Disk

Name

DOS-Pfad und Dateiname für den AWeb-Plugin oder das externe Programm.

Argumente

Argumente für den AWeb-Plugin oder das externe Programm.

NETSTATUSOPEN

Programmeinstellungen, Optionen: Netzwerk-Status automatisch öffnen.

Wert: Boolean (0 oder 1).

NEWS

Netzwerkeinstellungen, externe Programme: News:-Programm.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname für das News:-Programm oder -Skript
Argumente	Argumente für das Programm or Skript.

NOCACHE

Netzwerkeinstellungen, Puffer: Diese Sites nicht puffern.

Es handelt sich um eine Liste mit individuellen Namen oder Mustern.

Wert für jeden Eintrag: String.

NOCOOKIE

Netzwerkeinstellungen, Optionen: Keine Cookies für Domänen.

Es handelt sich um eine Liste mit individuellen Namen oder Mustern.

Wert für jeden Eintrag: String.

NOPROXY

Netzwerkeinstellungen, Proxy: Diese Sites ohne Proxy benutzen.

Es handelt sich um eine Liste mit individuellen Namen oder Mustern.

Wert für jeden Eintrag: String.

OVERLAP

Programmeinstellungen, Optionen: Scroll-Überschneidung (Pixel).

Wert: Darf nicht negativ sein.

PALETTE

Programmeinstellungen, Palette: Ändere Palette.

Diese Gruppe enthält die folgenden Einstellungen:

PALETTE.# (# = 0..7) Palette-Derfinition für diese Stift-Nummer.
Wert für alle Einträge: String mit sechs Hexadezimalstellen, welcher den RGB Farbwert (RRGGBB) spezifiziert.

PALETTE.# (# = 0..7)	Palette-Derfinition für diese Stift-Nummer.

POPUP

GUI-Einstellungen, Optionen: Popup-Menü-Aktivierung.

Wert: String bestehend aus keinem oder mehreren Einträgen:

A ALT-Taste
C Control-Taste
M Mittlere Maustaste
R Rechte Maustaste
S Shift-Taste

A	ALT-Taste
C	Control-Taste
M	Mittlere Maustaste
R	Rechte Maustaste
S	Shift-Taste

POPUPMENU

GUI-Einstellungen, Popup: Popup-Menü.

Es handelt sich um eine Liste mit individuellen Menüeinträgen.

Wert für jeden Eintrag: String mit dem Format:

   Menü NL Speicher NL Titel NL Befehl

Menü

Identifikation der Menüsektion, der dieser Punkt hinzugefügt werden soll:

I	Bilder Popup-Menü
L	Link Popup-Menü
F	Frame Popup-Menü

Ein Zeichen für eine neue Zeile (hexadezimal 0A).

Speicher

Zahl, die angibt, unter welchen Bedingungen der Menüpunkt gültig ist:

1	Menüpunkt wird angezeigt, wenn sich das Objekt im Speicher befindet
2	Menüpunkt wird angezeigt, wenn sich das Objekt nicht im Speicher befindet
3	Menüpunkt wird immer angezeigt

Dieser Indikator wird für das Frame Popup-Menü nicht verwendet, und hat den Wert Null.

Titel

Der im Menü angezeigte Titel des Menüpunktes.

Befehl

Der ARexx-Befehl, welcher bei Anwahl des Knopfes ausgeführt werden soll.

SAVEPATH

Programmeinstellungen, Optionen: Speicher-Pfad.

Wert: String, der einen DOS-Pfad angibt.

SCREEN

Programmeinstellungen, Bildschirm: Bildschirmeinstellungen.

Diese Gruppe enthält die folgenden Einstellungen:

SCREEN.TYPE Der Typ des Bildschirms, auf dem AWeb laufen soll.
Wert: 0, 1 oder 2:

0 Vorgegebener öffentlicher Schirm
1 Benannter öffentlicher Schirm
2 Eigener öffentlicher Schirm

SCREEN.NAME Name des öffentlichen Schirms, auf dem AWeb laufen soll.
Wert: String.
SCREEN.MODE Bildschirmmodus des öffentlichen Schirms.
Wert: String mit acht Hexadezimalstellen, welcher die ModeID spezifiziert.
SCREEN.WIDTH Breite des öffentlichen Schirms in Pixeln.
Wert: Positive Zahl.
SCREEN.HEIGHT Höhe des öffentlichen Schirms in Pixeln.
Wert: Positive Zahl.
SCREEN.DEPTH Tiefe des öffentlichen Schirms in Pixeln. (Anzahl an Bitplanes).
Wert: Positive Zahl.
SCREEN.PALETTE Indikator zum Laden einer verteilten Palette.
Wert: 0, 1 oder 2:

0 Aus
1 Farben
2 Graustufen

SCREENPENS

Programmeinstellungen, Palette: Stift-Einstellungen.

Wert: Ein aus neun Stift-Nummern bestehender String. Die einzelnen Stift-Nummern werden durch ein Leerzeichen getrennt. Die einzelnen Stifte sind im Folgenden nacheinander aufgeführt: Normaler Text, Helle Kanten, Dunkle Kanten, Titelbalken aktiver Fenster, Titeltexte aktiver Fenster, Hintergrund, Wichtiger Text, Menü-Text, Menü-Hintergrund.

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname des Skriptes, mit dem der TCP-Stack gestartet wird.
Argumente	Argumente für das Skript.

STYLE

Browsereinstellungen, Stile: Stil-Einstellungen. Diese Gruppe enthält die folgenden Einstellungen:

STYLE.H1 STYLE.H2 STYLE.H3 STYLE.H4 STYLE.H5 STYLE.H6 STYLE.BIG	STYLE.SMALL STYLE.SUB STYLE.SUP STYLE.ADDRESS STYLE.BLOCKQUOTE STYLE.CITE STYLE.CODE	STYLE.DFN STYLE.EM STYLE.KBD STYLE.PRE STYLE.SAMP STYLE.STRONG STYLE.VAR

Diese Stile sind zur Verwendung für diesen HTML-Tag vorgesehen, und entsprechen den Einträgen im Fenster für die Stile im Fenster der Browsereinstellungen.

Wert: Für STYLE.H1 bis STYLE.H6, String mit dem Format:

   Typ;absolute Größe;Stil

und für die anderen Merkmale, String mit dem Format:

   Typ;relative Größe;Stil

Typ

Type des zu verwendenden Zeichensatzes:

N	Normaler Zeichensatz
F	Zeichensatz mit fester Breite

absolute Größe

Zahl im Bereich von 1..7

relative Größe

Zahl im Bereich von -6..+6

Stil

String bestehend aus keinem oder mehreren der folgenden Einträge:

B	Fett
I	Kursiv
U	Unterstrichen

TELNET

Netzwerkeinstellungen, externe Programme: Telnet:-Programm.

Wert: String mit dem Format:

   Befehl;Argumente

Befehl	DOS-Pfad und Dateiname des Telnet:-Programmes oder -Skriptes.
Argumente	Argumente für das Programm oder Skript.

0	Immer
1	Einmal pro Sitzung
2	Nie